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EXPERIENCES  OF  THE  HYDROLOGIC  ENGINEERING  CENTER 
IN  MAINTAINING  WIDELY  USED  HYDROLOGIC  AND  WATER  RESOURCE  COMPUTER  MODELS 

By  Bill  S.  El  chert ^ 

INTRODUCTION  TO  HEC 

The  Hydrologic  Engineering  Center  (HEC)  of  the  United  States  Army  Corps 
of  Engineers,  located  in  Davis,  California,  was  established  In  1964  to  serve 
all  52  offices  of  the  Corps  of  Engineers  (Corps)  in  the  area  of  hydrologic 
engineering.  Its  mission  was  later  expanded  to  include  development  and  imple¬ 
mentation  of  analytical  planning  techniques.  The  Center’s  basic  purpose  is  to 
assist  practicing  engineers  throughout  the  Corps  in  applying  state-of-the-art 
technology  to  current  planning,  design  and  operation  problems.  This  basic 
purpose  is  accomplished  by  locating,  evaluating  and/or  developing  new  proce¬ 
dures  and  techniques  (primarily  mathematical  models),  by  teaching  these  and 
other  state-of-the-art  techniques  in  approximately  24  weeks  of  formal  training 
courses  each  year,  by  developing  and  maintaining  a  library  of  some  12  major 
state-of-the-art  computer  programs,  and  by  assisting  Corps  offices  in  apply¬ 
ing  these  techniques  in  current  studies.  The  above  missions  are  presently 
accomplished  through  a  staff  of  approximately  40  employees,  including  25  engin 
eers,  5  computer  system  analysts  and  10  technicians  and  clerical  support  per¬ 
sonnel.  An  annual  budget  of  about  $1,850,000  includes  about  $500,000  reimbur¬ 
sable  work  for  assisting  in  project  studies,  $250,000  for  training,  $150,000 
for  program  maintenance  and  $950,000  for  research  and  development  (Including 
developing  and/or  improving  computer  models). 

^Director,  The  Hydrologic  Engineering  Center,  609  Second  Street,  Suite  0, 
Davis,  California  95616  USA. 


MAJOR  HEC  PROGRAMS 

All  major  HEC  programs  (see  Table  1)  are  written  to  be  useful  on  a  fairly 
wide  range  of  problems  In  a  specific  area  of  hydrologic  engineering  or  water 
resource  planning.  They  are  also  generalized  so  that  they  can  be  used  in  about 
95t  of  the  studies  without  any  code  changes.  Input  data  is  used  to  describe 
site  specific  data.  The  programs  are  written  using  FORTRAN  statements  which 
are  acceptable  on  most  computers  so  that  the  programs  are  transportable  to 
many  different  computer  systems  with  little  or  no  modification.  Specific 
rules  (which  will  be  discussed  later)  followed  In  producing  this  code  were 
derived  by  experience  gained  from  converting  the  programs  to  many  other  systems 
over  several  years.  The  major  HEC  programs  which  are  being  supported  by  HEC 
in  the  production  mode  are  shown  In  Table  2.  Many  other  smaller  production 
programs  are  available  and  several  other  major  programs  are  still  in  the  research 
stage,  such  as  our  work  in  two-dimensional  hydrodynamics. 

HEC  CYCLE  OF  PROGRAM  SUPPORT 

The  HEC  cycle  for  computer  support  includes  the  important  steps  of: 

a.  Research.  Program  development  and  Improvement. 

b.  Documentation.  User  manuals,  programmers  manuals,  training  documents, 
special  application  reports. 

c.  Training.  Formal  courses  (1-2  weeks  each),  video  tapes,  individual 
training. 

d.  User  Support.  Consulting,  answering  telephone  calls,  reviewing  jobs 
mailed  to  HEC,  correcting  errors  in  program. 

e.  Distribution.  Mailing  publications,  source  decks,  test  data  and 
computer  solutions. 
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TABLE  1 


MAJOR  HEC  COMPUTER  PROGRAMS 


Program  Size 

No.  of  Offices  on  List  of  Source  Deck 
Holders  as  of  15  November  1976 

Program 

No.  of 
Statements 

Core1 

Storage 

(Words) 

Corps 

Other  Govt., 
Universities, 
Foreign 

Private 

Total 

HEC-1,  Flood  Hydrograph 
Package 

4,150 

68K 

28 

141 

231 

400 

HEC-2,  Water  Surface 

Profiles 

8,000 

44K 

42 

228 

362 

632 

HEC-3,  Reservoir  System 
Analysis  for  Conservation 

4,030 

66  K 

20 

64 

41 

125 

HEC-4,  Monthly  Streamflow 
Simulation 

1,985 

60K 

15 

76 

45 

136 

HEC-5C,  Simulation  of  Flood 
Control  and  Conservation 
Systems 

12,000 

122K 

11 

42 

17 

70 

HEC-6,  Scour  and  Deposition 

In  Rivers  and  Reservoirs 

6,000 

53K 

18 

33 

15 

66 

Urban  Runoff:  Storage, 
Treatment  and  Overflow 
(STORM) 

5,200 

66K 

19 

109 

113 

241 

Regional  Frequency 

Computation 

1,330 

43K 

19 

44 

34 

97 

Gradually  Varied  Unsteady 

Flow  Profiles 

4,300 

55K 

25 

37 

26 

88 

Water  Quality  for  River- 
Reservoir  Systems 

7,800 

71 1C 

5 

43 

23 

71 

All  Others 

— 

— 

122 

423 

269 

814 

Total 

324 

1,240 

1,176 

2.740 

1 


Core  storage  requirements  are  based  on  a  CDC  CYBER  175  located  at  Boeing  Computer  Company 
In  Seattle,  Washington  and  are  shown  In  words  (base  no.) 

G 
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f.  Feedback.  From  user  to  HEC  on  Input  problems,  program  errors,  desired 
program  Improvements. 

The  methods  used  by  HEC  In  each  of  the  steps  above  are  described  as  follows: 

a.  Research.  Most  HEC  supported  programs  were  developed  by  HEC,  but  a 
few  of  the  programs  such  as  the  STORM  AND  WQRRS  programs  were  Initially  devel¬ 
oped  by  others  and  have  been  adapted  and  improved  by  HEC  or  by  contractors  to 
HEC  over  the  years.  Improvements  to  the  programs  are  Important,  for  unless 
the  programs  are  kept  up-to-date,  they  will  no  longer  be  used  and  the  results 
of  the  research  will  be  terminated. 

b.  Documentation.  Computer  program  documentation  is  generally  accom¬ 
plished  with  separate  users  and  programmers  manuals.  The  programmers  manual 
provides  useful  information  for  implementing  the  program  on  the  user's  com¬ 
puter.  The  users  manual  explains  what  technical  procedures  are  used  in  the 
program,  how  it  operates,  how  to  code  input  for  the  program,  and  how  to  inter¬ 
pret  output.  Notification  of  program  error  corrections  and  improvements  is 
made  periodically  to  all  current  source  deck  holders.  Other  HEC  publications 
include  training  course  notebooks,  newsletters,  professional  papers,  and  com¬ 
puter  program  abstracts. 

c.  Training.  Each  year  approximately  24  weeks  of  training  are  provided 
by  HEC  for  Corps  personnel  in  1  to  2  week  courses.  Approximately  10  percent 

of  the  spaces  in  these  courses  is  reserved  for  personnel  from  other  U.S.  Federal, 
state  and  university  offices.  Two  special  4-week  courses  were  given  to  foreign 
representatives  ir,  1972  and  1974  as  a  U.S.  contribution  to  the  International 
Hydrological  Decade.  A  number  of  U.S.  and  Canadian  universities  are  using 
HEC  developed  courses  and/or  are  using  HEC  computer  models  in  their  courses. 
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Individual  training  is  performed  by  HEC  to  meet  specific  needs  not  met  by  the 
formal  courses.  Arrangements  have  been  made  by  the  U.S.  State  Department  for 
foreign  training  by  HEC.  Fifteen  of  the  HEC  courses  have  been  videotaped,  and 
the  223  tapes  are  available  for  loan  along  with  instructional  material  (lecture 
notes,  visual  aids  and  references).  These  tapes  are  particularly  useful  when 
someone  who  has  taken  the  course  is  available  to  answer  questions  after  the 
tapes  are  viewed.  Visitors  to  HEC  desiring  individual  training  on  a  certain 
computer  model  often  use  these  video  tapes  before  getting  individual  help  on 
solving  a  particular  problem.  Eleven  visitors  from  Brazil  recently  received 
4  weeks  of  training  at  HEC  using  this  approach.  In  spite  of  the  above, 
insufficient  training  is  currently  available  to  the  non-Corps  user. 

d.  User  Support.  The  HEC  provides  support  to  the  HEC  programs  by  assigning 
each  program  to  an  engineer  who  answers  calls  on  the  program  concerning  program 
capabilities  and  limitations,  input  problems  and  program  aborts.  Sometimes 
program  executions  are  reviewed  to  help  the  user  find  input  errors  or  to  correct 
program  errors. 

'if 

e.  Source  Deck  Distribution.  As  shown  in  Table  1,  the  HEC  has  distributed  ? 

!$■ 

source  decks  to  a  variety  of  different  offices.  Based  on  our  survey  in  November  1976, 
over  2,700  source  decks  are  still  considered  active  by  the  using  offices.  Each 
year  approximately  700  new  source  decks  are  requested.  Assistance  to  program 
users  is  provided,  to  the  extent  possible,  in  implementing  the  models  in  their 
equipment,  answering  questions  on  use  of  models  and  eliminating  program  malfunctions. 
These  services  are  provided  without  charge  except  that  private  firms  are  charged 
a  $60  reproduction  and  handling  fee  for  each  source  deck  and  set  of  documentation 
provided. 


f.  Feedback.  Users  of  HEC  programs  have  provided  valuable  feedback  to 


MEC  In  terms  of  needed  improvements  in  program  capabilities,  documentation 
deficiencies,  program  malfunctions,  etc. 

Each  of  the  steps  in  the  program  support  cycle  is  an  important  link. 

If  one  or  more  of  these  steps  is  missing  or  neglected  It  will  eventually  stop 
the  cycle  and  prevent  the  generalized  code  from  being  used  effectively.  The 
program  support  cycle  cannot  get  started  until  the  models  are  in  demand  by 
various  users. 


WAYS  TO  ENCOURAGE  USAGE  OF  THE  MODELS 

Technology  can  be  transferred  very  effectively  through  computer  models. 
However,  many  very  good  computer  models  have  been  developed  which  will  never 
be  effectively  used  because  of  model  limitations,  poor  model  documentation  or 
lack  of  support  for  the  model.  The  HEC  has  tried  to  observe  the  following 
principles  in  order  to  make  the  models  more  attractive  and  useful  to  the  user. 

a.  Use  Commonly  Accepted  Techniques.  In  HEC  models  we  have  tried  to  pro¬ 
vide  several  of  the  best  available  methods  so  that  a  user’s  personal  preference 
can  be  satisfied.  For  Instance,  some  6  different  flood  routing  methods  and 

4  different  loss  rate  functions  are  incorporated  into  our  HEC-1  Flood  Hydro¬ 
graph  Package. 

b.  Make  Models  Generalized  and  Flexible.  A  complex  computer  model  that 
is  designed  for  a  specific  project  nay  be  very  valuable  for  that  project,  but 
probably  is  not  useful  for  the  same  type  of  project  at  another  site.  At  HEC 
we  try  to  write  major  models  so  that  a  large  proportion  of  similar  types  of 
problems  at  other  locations  can  be  solved  without  any  program  modification. 

The  programs  are  written  in  large  packages  so  that  most  problems  in  that  general 
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field  of  Interest  can  be  solved  with  the  same  model.  All  programs  are  written 
In  FORTRAN  IV  in  such  a  way  that  they  are  easily  transported  to  a  wide  range 
of  different  computers. 

c.  Hake  Input  Simple.  Most  models  in  use  today  are  difficult  to  use  because 
not  enough  attention  was  given  to  making  the  input  user-oriented.  The  amount  of 
use  the  program  will  receive  by  others  is  heavily  influenced  by  how  easy  the 

the  program  is  to  use. 

d.  Make  Documentation  Simple  and  Readable.  Models  that  have  extensive 
computational  capabilities  in  solving  complex  programs  are  easy  to  find.  Models 
with  good  documentation  are  very  hard  to  find.  Too  much  documentation  will 
scare  away  a  potential  user,  and  too  little  will  leave  a  potential  user  frus¬ 
trated  and  angry.  The  documentation  should  be  written  so  that  the  beginner 

can  easily  use  the  model  on  a  simple  problem  and  the  experienced  user  can  use 
the  model  on  a  complex  problem. 

e.  Support  the  Finished  Model.  In  very  few  cases  are  knowledgeable  per¬ 
sonnel  available  to  help  users  effectively  use  the  models.  All  major  HEC  models 
are  supported  by  one  or  more  persons  who  help  users  by  answering  questions 

on  the  telephone  and  by  tracing  down  user  problems.  A  lack  of  model  support 
by  the  developing  office  is  perhaps  the  most  important  reason  why  some  models 
are  not  effective  in  transferring  technology.  A  good  model  sitting  on  the 
shelf  without  any  support  is  worthless.  Model  support  can  require  a  substan¬ 
tial  amount  of  manpower  and  funds.  Good  documentation  and  simple  Input  can 
greatly  help  In  reducing  the  required  support.  While  the  Increased  use  of  the 
model  increases  the  success  of  the  technology  transfer,  the  requirements  for 
support  of  the  model  are  also  increased,  sometimes  beyond  the  office’s  capa¬ 
bility  to  provide  that  support.  The  support  required  on  the  IIEC-2  model  with 
over  600  offices  currently  using  It  has  reached  the  point  where  2-3  people  are 
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spending  almost  half-time  on  the  support  activity. 


The  amount  of  support  that  is  provided  for  a  model  should  be  dependent 
upon  how  much  the  model  is  being  used.  If  a  program  has  few  users,  then  per¬ 
haps  the  support  effort  (mainly  improvements)  should  be  transferred  to  more 
successful  models.  Determining  the  extent  of  use  of  the  models  is  very  dif¬ 
ficult  when  many  different  computers  are  being  used.  Results  from  surveys  such 
as  that  shown  in  Table  2  are  quite  useful  when  based  on  questionnaires  of  known 
program  users.  Table  2  shows  that  much  more  use  is  being  made  of  our  HEC  program 
in  the  private  sector  than  in  our  own  Corps  offices.  Other  results  show  what 
additional  program  capabilities  need  to  be  added  and  where  difficult  input 
coding  problems  occur.  Where  programs  are  used  by  many  offices  on  the  same  com¬ 
puters,  routines  like  our  SNOOPY  program  can  be  added  to  provide  periodic  infor¬ 
mation  on  program  usage,  options  called,  etc.,  as  shown  in  Table  3. 
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TABLE  2 


RELEASE  OF  NOVEMBER  1976  VERSION  OF  HEC-2 


SOURCE  DECK  DISTRIBUTION 


Type  of  User 

Private  (U.S.) 

Corps 

Other  Federal 

State  or  Local  Government 

University  (U.S.) 

Private  (Foreign) 

Foreign  Government 
University  (Foreign) 


Number 

98 

18 

11 

54 

29 

7 

11 

3 


Total  231 


USAGE  SURVEY 


Type  of  User 

Number  of 
Offices 
Responding 

Program 

Has  Been 
Used  During 
Last  3  Mos. 

Number 
of  People 
Using  HEC-2 

Approx.  No. 
of  Program 
Executions 
Per  Year 

Pri vate 

137 

101 

921 

84,161 

Corps 

24 

21 

243 

34,010 

Other  Federal 

12 

7 

57 

1  ,045 

State  or  Local  Government 

52 

35 

284 

12,665 

University  (U.S.) 

25 

13 

216 

2,488 

Others 

3 

3 

10 

1  ,000 

Totals 

253 

180 

1 ,731 

135,369 

9 


TABLE  3 


NUMBER  OF  EXECUTIONS  OF  HEC  COMPUTER  PROGRAMS 
AT  THE  LAWRENCE  BERKELEY  LABORATORY 
DURING  A  10-MONTH  PERIOD 


Number  of  Executions 


Month 

HEC-1 

HEC-2 

HEC-5C 

Freq 

Anal . 

Unsteady 

Flow 

October  1976 

374 

1,307 

82 

80 

86 

November  1976 

295 

1,363 

64 

129 

89 

December  1976 

270 

1 ,462 

100 

164 

79 

January  1977 

* 

1  ,661 

357 

162 

35 

February  1977 

♦ 

1  .712 

954 

176 

123 

March  1977 

* 

2,243 

420 

195 

32 

April  1977 

* 

899 

363 

199 

28 

May  1977 

* 

1,764 

187 

218 

91 

June  1977 

* 

2,807 

284 

176 

66 

July  1977 

* 

2,412 

306 

104 

103 

Total 

939 

17,630 

3,117 

1  ,603 

732 

Projected 

Annual 

Total* ** 

3,756 

21,156 

3,740 

1  ,924 

878 

*  SNOOPY  routine  not  in  operation. 

**  Projected  annual  total  obtained  by  dividing  "total"  figures  by  number  of 
months  figures  were  available,  and  multiplying  by  12. 
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COST  AND  MANPOWER  FOR  PROGRAM  SUPPORT 


The  estimated  costs  and  manpower  requirements  for  supporting  the  generalized 
computer  programs  in  the  HEC  library  are  shown  in  Table  4.  The  support  efforts 
are  a  function  of  many  factors.  Including  the  number  of  users,  the  extent  of 
use  by  each  user,  the  technical  background  of  the  user,  the  amount  of  training 
the  user  has  In  the  subject  area  and  subject  program,  and  the  amount  of  exoer- 
ience  the  user  has  In  using  a  particular  program.  Two  or  three  of  our  programs 
require  about  half  of  our  total  support  efforts,  while  several  programs  require 
very  little  support.  Our  development  and  improvement  costs  vary  considerably 
from  year  to  year  and  from  program  to  program.  Initial  development  costs  of  a 
typical  large  HEC  program  are  $100,000.  While  the  program  is  still  In  a  pro¬ 
duction  mode,  additional  Impro.ements  over  a  5  to  10  year  period  may  increase 
that  total  cost  to  about  $500,000. 

Total  support  costs  (which  exclude  the  development/improvement  costs)  of 
the  12  major  programs  In  the  HEC  have  not  changed  greatly  In  the  last  2  years 
since  the  number  of  users  has  gradually  leveled  off. 

COMP AT ABILITY  WITH  OTHER  COMPUTER  SYSTEMS 

Even  though  FORTRAN  Is  a  common  computer  language  available  in  most  scien¬ 
tific  computing  systems,  care  must  be  exercised  to  prepare  programs  that  will 
execute  on  all  systems.  This  is  because  most  FORTRAN  compilers  made  available 
by  vendors  contain  variations  or  enhancements  to  the  standard  FORTRAN  language 
that  may  not  be  available  or  at  least  implemented  in  the  same  way  on  other 
systems. 

To  produce  the  most  usable  code  for  all  FORTRAN  installations: 

a.  Isolate  file  initialization  statements  at  the  beginning  of  the  main 
program  for  easy  adaptation  to  other  systems. 
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TABLE  4 


COST  AND  MANPOWER  FOR  PROGRAM  SUPPORT 


Item 

Training  Courses  -  Development  A  Presentation 
Program  -  Development/ Improvement 
User  Support 

Documentation  -  Development/Improvement 
Maintain  Programs  on  Two  3-Computer  Systems 
Video  Tapes  and  Support  Documents  -  Distribute 
Source  Decks  -  Reproduce  &  Distribute 
Documentation  -  Reproduce  &  Distribute 
Video  Tapes  -  Development 

Totals 


Approx.  No. 
Products 

Per  Year 

Annual 

Cost 

HEC  Programs 

Equivalent 
Full  Time 
Employee 

22  Weeks 

250,000 

4.0 

12 

200,000* 

3.5 

12  Major 
Programs 

85,000 

2.0 

15 

30,000 

.5 

3 

20,000 

.5 

500 

5,000 

.5 

700 

40,000 

.3 

4,000 

15,000 

.2 

100 

15,000 

.1 

$660,000 

11.6 

♦Estimated  part  of  $950,000  annual  research  program  used  for  12  major  programs  currently 
supported  by  HEC. 
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b.  Avoid  BACKSPACE  statements. 

c.  Use  standard  READ  and  WRITE  statements  for  I/O  operations. 

d.  Restrict  alphanumeric  input/output  to  four  characters  per  word  (A4). 

e.  Use  no  more  than  3  subscripts  for  arrays. 

f.  Prepare  code  In  logical  subroutine  units  that  can  be  debugged  Inde¬ 
pendent  of  other  routines,  and  overlayed  in  smaller  machines  as  necessary. 

g.  Avoid  multiple  entry  points  in  a  subprogram. 

h.  If  variable  dimensions  are  required,  pass  the  dimension  limit  in  the 
call  statement,  not  In  common  areas. 

1,  Place  DATA  statements  that  preset  labeled  common  areas  In  BLOCK  DATA 
subprograms. 

j.  Use  care  where  loss  of  precision  may  affect  computer  results,  such  as 
In  differences  of  numbers  of  nearly  equal  magnitudes.  It  may  require  DOUBLE 
PRECISION  In  some  machines  to  give  the  same  result  as  single  precision  gives 
In  others. 

k.  Where  special  features  of  a  system  are  germane  to  the  operation  of  a 
program,  such  as  direct  access  I/O,  character  manipulation,  etc..  Isolate  them 

In  a  single  subroutine  that  may  be  easily  adapted  to  other  systems.  1 

1 

IMPLEMENTING  PROGRAMS  ON  OTHER  SYSTEMS  * 

3 

* 

The  costs  and  manpower  requirements  to  transport  computer  programs  to  * 

other  systems  are  difficult  to  estimate.  If  programs  are  transported  frequently  j 

and  feedback  on  the  difficulties  encountered  are  corrected,  then  eventually  the  j 
programs  become  quite  portable.  This  is  the  case  with  most  HEC  programs. 

Recent  HEC  benchmark  programs  were  converted  to  several  different  United  States 
Computers  in  a  few  days'  time.  Typical  conversion  times  for  a  single  HEC  pro¬ 
gram  should  require  less  than  one  man-day  of  work,  given  that  the  computer  system 
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Is  large  enough  and  that  the  programmer  Is  skilled  on  his  system.  Host  dif¬ 
ficulties  for  HEC  programs  have  been  encountered  by  users  who  had  IBM  equip¬ 
ment,  because  of  lack  of  core  memory,  symbol  table  storage  deficiencies  in  the 
compiler,  or  problems  with  double  precision  (not  knowing  what  variables  have  to 
have  double  words).  The  most  common  problem  for  non-IBM  users  has  been  a  lack 
of  core  storage,  but  that  problem  Is  very  rare  now  except  for  one  or  two  HEC 
programs. 

The  main  problems  in  sending  HEC  source  decks  to  foreign  countries  is  that 
many  offices  have  the  smaller  IBM  systems  and  that  the  feedback  from  those 
countries  to  HEC  is  less  than  adequate  because  of  lengthy  communication  times 
and  security  problems  on  both  ends.  In  spite  of  a  few  problems,  good  success 
has  been  experienced  in  transporting  HEC  programs  to  over  700  different  offices 
per  year  Including  many  foreign  countries. 

CONCLUSIONS 

The  use  of  generalized  models  can  be  an  effective  tool  in  accomplishing 
water  resource  studies  If  sufficient  funds  and  manpower  are  provided  to  support 
the  necessary  functions  described  in  this  paper.  Information  on  manpower  and 
costs  provided  In  this  report  may  be  useful  in  estimating  the  necessary  logis¬ 
tic  support  required  for  similar  support  centers  in  other  offices. 
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